Malla Societaria Personas

Este endpoint permite extraer la información de malla societaria de Personas asociada a un RUT previamente cargado en tu cuenta de Sheriff.

• No se generará ningún costo adicional al consultar información de un RUT ya cargado en la plataforma.
• Asegúrate de que el RUT esté pre-cargado en la plataforma antes de intentar extraer su información.

Detalle de API

Request

• URL: /helper/legal/{rut}/mallaSocietariaPersonas
• Método: GET

Parámetros

• rut (requerido): El RUT del cual se desea extraer la información. Formato del rut "12345678-9".

Ejemplo request con curl

curl -X 'GET' \
  'https://prod.api.thesheriff.cl/api/clients/v2/helper/legal/12345678-9/mallaSocietariaPersonas?page=1' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123' \
  -H 'x-client-identifier: SheriffSecureClient-v1'

Response

Success

• Status code: 200

• Example response body:

  {
    "success": true,
    "data": {
      "page": 1,
      "totalPages": 1,
      "cantidad": 1,
      "casos": [
        {
          "rut": "12345678-9",
          "rutSociedad": "98765432-1",
          "nombreSociedad": "Empresa S.A.",
          "rol": ["socio", "administrador"],
          "socios": [
            {
              "rut": "12345678-9",
              "monto": "$100.000 CLP",
              "socio": "Socio 1",
              "acciones": "1000",
              "domicilio": "Direccion del domicilio/local",
              "porcentaje": "100%"
            },
            {
              "rut": "12344322-1",
              "monto": "$1.000 PESOS",
              "socio": "Socio 2",
              "acciones": "10",
              "domicilio": "Direccion del domicilio/local",
              "porcentaje": "1%"
            }
          ],
          "administradores": [
            {
              "rut": "12345678-9",
              "domicilio": "Direccion del domicilio/local",
              "administrador": "Administrador 1"
            }
          ]
        }
      ],
      "ultimaActualizacion": "10-03-2026 10:00:00"
    }
  }

A continuación se describen los campos devueltos en la respuesta JSON.

Campo	Tipo	Descripción
success	bool	Indica si la operación fue exitosa.
data	object	Objeto con la paginación y los casos.

Campos dentro de data:

Campo	Tipo	Descripción
page	number	Página actual de resultados.
totalPages	number	Cantidad total de páginas disponibles.
cantidad	number	Número total de casos encontrados.
casos	array	Lista de objetos, uno por cada sociedad vinculada al RUT.
ultimaActualizacion	string	Fecha y hora de la última actualización (formato "dd-mm-aaaa HH:MM:SS").

Estructura de cada objeto dentro de casos:

Campo	Tipo	Descripción
rut	string	RUT de la persona vinculada.
rutSociedad	string	RUT de la sociedad vinculada.
nombreSociedad	string	Nombre de la sociedad.
rol	array	Roles que desempeña la persona en la sociedad (ej: ["socio","administrador"]).
socios	array	Lista de socios de la sociedad (ver estructura abajo).
administradores	array	Lista de administradores de la sociedad (ver estructura abajo).

Estructura de cada elemento dentro de socios:

Campo	Tipo	Descripción
rut	string	RUT del socio.
monto	string	Monto aportado o capital.
socio	string	Nombre completo del socio.
acciones	string	Número de acciones o participación.
domicilio	string	Domicilio del socio; puede ser null si no aplica.
porcentaje	string	Porcentaje de participación (ej: "100%", "50%").

Estructura de cada elemento dentro de administradores:

Campo	Tipo	Descripción
rut	string	RUT del administrador.
domicilio	string	Domicilio del administrador.
administrador	string	Nombre completo del administrador.

Nota: Los campos marcados como "No" pueden no estar presentes o ser null según disponibilidad de datos en la fuente.

Errores

400 - Solicitud inválida

{
  "success": false,
  "code": 400,
  "error": "Solicitud inválida"
}

401 - No autorizado

{
  "success": false,
  "code": 401,
  "error": "No autorizado"
}

403 - No tienes permiso para acceder a este recurso

{
  "success": false,
  "code": 403,
  "error": "No tienes permiso para acceder a este recurso"
}

404 - Recurso no encontrado

{
  "success": false,
  "code": 404,
  "error": "Recurso no encontrado"
}

408 - Tiempo de espera agotado

{
  "success": false,
  "code": 408,
  "error": "Tiempo de espera agotado"
}

429 - Demasiadas solicitudes

{
  "success": false,
  "code": 429,
  "error": "Demasiadas solicitudes"
}

500 - Error interno del servidor

{
  "success": false,
  "code": 500,
  "error": "Error interno del servidor"
}